home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 31 / Amiga Format CD31 (1998-09-02)(Future Publishing)(GB)(Track 1 of 2)[!][issue 1998-10].iso / -readerstuff- / stu_mackie / metrix / metrix.doc < prev    next >
Text File  |  1998-07-27  |  10KB  |  303 lines

  1.  
  2.     =============
  3.      M E T R I X
  4.     =============
  5.  
  6.     - C O N T E N T S -
  7.  
  8.     Why?
  9.     What Is It?
  10.     Cost? Free?
  11.     Requirements
  12.     Installation
  13.     Usage
  14.     Problems?
  15.     Copyright
  16.     Distribution
  17.     Disclaimer
  18.     Contact...
  19.  
  20.     =====================
  21.     (c) 1997 - Stu Mackie
  22.     =====================
  23.  
  24.  
  25.  Why?
  26.  ----
  27.  
  28.  One day... I had to convert a number of measurements (as you do), and
  29.  I only had to use the table in the back of my Dictionary, didn't I?
  30.  "Stone me, Gov!" I hear you cry.
  31.  So I thought "Wouldn't it be handy to have my Amiga do it for me?"
  32.  Then I thought "Nah, not really", but I did it anyway. Well it was either
  33.  that, or go to the pub. So I came back stinking of lager and curry, and
  34.  decided there and then that it IS a good idea after all - in much the
  35.  same way that you think, after a pint, that getting a tattoo and Keanu
  36.  Reeves playing Superman is a good idea.
  37.  
  38.  So, it took about a week to write, 12.5 seconds to test (never liked that
  39.  bit), and it's in Blitz Basic.
  40.  
  41.                                                               Enjoy... Stu.
  42.  
  43.  
  44.  What is it?
  45.  -----------
  46.  
  47.  A combination of Internal Functions, and User-Entered Formula, convert
  48.  a multitude of measurements - restricted for the most part, only by
  49.  your imagination.
  50.  
  51.   For fun only tho - don't go creating your nuclear arsenal based
  52.   on measurements from MetriX now, will you?
  53.  
  54.   Add your own conversions to the following list of over 400 included...
  55.  
  56.   Converts : Acres,Ares,Hectares,Square Rods,Square Feet, Square Yards,
  57.   Centiares,Bushels,Pecks,Cubic Inches,Litres,Quarts,Pints,Gills,Gallons,
  58.   Fluid Ounces,Fathoms,Cables,Feet,Metres,Nautical Miles,Kilometres,
  59.   Statute Miles,Grains,Milligrams,Grams,Carats,Pennyweight,Inches,Mils,
  60.   Centimetres,Cubic Centimetres,Cubic Decimetres,Cubic Feet,Cubic Yards,
  61.   Cubic Millimetres,USA Gallons,Minums,Fluid Drams,Millilitres,Days,Hours,
  62.   Seconds,Weeks,Years,Leap Years,Millennia,Quadrennia,Decigrammes,Ounces,
  63.   Scruples,Pounds,Rods,Furlongs,Miles,USA Pints,Square Kilometres,Minutes,
  64.   HundredWeight,Stones,Kg/Square Inch,Lbs/Square Inch,Kilobytes,Megabytes,
  65.   Bytes,Hectogrammes,Tons,Long Tons,Short Tons,Metric Tons,Quintals,
  66.   Degrees,Centigrade,Fahrenheit,Hex,Decimal,Binary,Date,Time,RAM,etc...
  67.  
  68.  o Full-screen 640x512 32 colour display.
  69.  o Large digital calculation-type thingy.
  70.  o Dual Listbox-type thingy for easy access to "the one you want" quickly
  71.    and easily.
  72.  o Mini functions also check current date, time and memory usage.
  73.  o Edit any preset (excluding internal functions), or add your own.
  74.  o Save your data.
  75.  o Uses Mouse and Keys.
  76.  o Can be hidden behind your Workbench screen.
  77.  o Doesn't halt running of Workbench.
  78.  
  79.  
  80.  Cost?? Shareware? Nah...
  81.  ------------------------
  82.  
  83.  No annoying requesters. No demo version. The full Monty.
  84.  
  85.  Do with it as you wish.
  86.  
  87.  If you really want to send a postcard, bug-reports, suggestions etc,
  88.  then my address is at the bottom of this Doc.
  89.  
  90.  
  91.  Requirements:
  92.  -------------
  93.  
  94.  o An Amiga. At least 1 MB free memory.
  95.  
  96.  o Ideally a hard-drive, for speed and data storage.
  97.    If you're running from floppy, then make sure the disk is write-
  98.    enabled if you wish to update the datafile.
  99.  
  100.  o "Helvetica.font" in your Fonts: directory.
  101.    Only the 24-point font is used
  102.    This font is included on your Workbench disks, if you can't find
  103.    it, and it isn't included in this archive, then you'll probably
  104.    find it on any Amiga CD.
  105.  
  106.  o Libraries:
  107.    ----------
  108.  
  109.    Uses standard Amiga libraries, however ensure you've the
  110.    popular "Mathtrans.Library" somewhere in your LIBS: path.
  111.  
  112.  
  113.  
  114.  Installation:
  115.  -------------
  116.  
  117.  Just drag the drawer to wherever you want it - and make sure
  118.  "Helvetica.font" is in your Fonts: Directory - that's it!
  119.  No assigns required. Just double-click the "MetriX" icon.
  120.  The file "MetriX.Data" should be in the same drawer as "MetriX".
  121.  
  122.  Archive contains:
  123.  
  124.          MetriX (Drawer)
  125.                 MetriX                --- Executable
  126.                 MetriX.info
  127.                 MetriX.Data           --- Formulas Datafile
  128.                 MetriX.ReadMe         --- Short Description
  129.                 MetriX.ReadMe.info
  130.                 MetriX.Doc            --- This Be It!!!
  131.                 MetriX.Doc.info
  132.                 MetriX.ScreenShot     --- Screenshot
  133.  
  134.  
  135.  If the file "MetriX.Data" is lost for any reason, the prog will still
  136.  work, but you'll only have the Internal Functions available, until
  137.  you enter some new ones!!
  138.  
  139.  This file is left unencrypted, so you can edit it by hand if you wish.
  140.  If you do this however, then make sure each line entered is terminated
  141.  with a "NEWLINE" (ie. Press (ENTER), just to be on the safe side. If it
  142.  fails to load correctly after editing by hand, then er... go do it again!
  143.  
  144.  Otherwise, only edit within MetriX.
  145.  
  146.  How To Use It...
  147.  ----------------
  148.  
  149.  On running "MetriX" you'll see the title. Just click the mouse and the
  150.  "Conversion Master" screen should appear.
  151.  
  152.  It's easiest to just run it and see for yourself, but for the full story...
  153.  
  154.  Select what you want to convert from, and what you want to convert to,
  155.  and then type in what you want to convert (Number keys on keyboard or
  156.  numeric keypad) and press (ENTER/RETURN).
  157.  
  158.  Use (DEL/BACKSPACE) to delete a character.
  159.  
  160.  Prefix your entry with a minus "-" if you want negative values.
  161.  
  162.  You can use the keys "ABCDEF" if you're converting Hex. There are limits
  163.  regarding Hex and Binary - but it's all fairly simple.
  164.  
  165.  You'll see counters indicating how many functions exist, and how many
  166.  updates you've made (if any) since you started.
  167.  
  168.  The (UP/DOWN) cursor keys will take you thru the last 10 conversions,
  169.  and whichever conversion is displayed may be recalled using the
  170.  (LEFT/RIGHT) cursor keys, depending on whether you want the "To" data
  171.  or the "From" data recalled.
  172.  
  173.  Of course, you can use the buttons instead if you wish.
  174.  
  175.  To Add a new entry, select "ADD", enter the "To" and "From" fields,
  176.  and also enter the formula for the calculation (press (ENTER) on this
  177.  field to store your entry).
  178.  
  179.  Formulas are just a number (ie. 0.625) to be multiplied by.
  180.  
  181.  To discover what the formula should be, it may be best to work it out
  182.  on a scrap of paper first, but as a general rule...
  183.  
  184.  One {From} Equals {Formula} {To}
  185.  
  186.  For example: One {Millimetre) Equals {0.1} {Centimetre}
  187.               Here you would enter "Millimetre" in the {From} field,
  188.               "Centimetre" in the {To} field, and "0.1" in the
  189.               {Formula} field. Any calculation then performed using
  190.               this formula will be correct - ie. if you were doing a
  191.               conversion of Millimetres to Centimetres and you entered "10"
  192.               and pressed (ENTER), then your "10" would be multiplied
  193.               by "0.1", (which is the formula) to give the answer "1".
  194.               So "10" Millimetres equals "1" Centimetre.
  195.               It's easier in practice believe me.
  196.  
  197.  When ADDing a new entry... if you wish it to appear sorted beneath a
  198.  heading already in existence then make sure you spell the "To" field
  199.  exactly as it currently exists. So if you're ADDing a "Centimetres To
  200.  Metres" conversion and you already have a "Centimetres To Millimetres",
  201.  then spell "Centimetres" in the {To} field exactly as it already exists
  202.  then your "Metres" option will be sorted beneath the original
  203.  "Centimetres" {From} category alongside the "Millimetres" option.
  204.  Again, it's just easier to try it and you'll see what I mean.
  205.  
  206.  To Edit an entry, select the entry using the two listboxes, and
  207.  click the "EDIT" button. Adjust the Formula, and press (ENTER).
  208.  
  209.  To Delete an entry, select the entry you wish to delete using the two
  210.  listboxes, and click the "EDIT" button, followed by the "DEL" button.
  211.  
  212.  To Cancel an update, just click a Listbox.
  213.  
  214.  Click the Disk Icon to save your changes. No changes will be saved
  215.  unless you do this, so if you make a mess, you can just quit.
  216.  
  217.  May be best to make a backup of the "MetriX.Data" file just in case!!!
  218.  
  219.  Any error messages and such, are displayed at the bottom of the screen.
  220.  
  221.  
  222.  Troubleshooting:
  223.  ----------------
  224.  
  225.    There shouldn't be any problems, but...
  226.  
  227.  o Is "Helvetica.font" (point-24) in you Fonts: Drawer?
  228.  
  229.  o Got a Megabyte free?
  230.  
  231.  o "MetriX.Data" in your "MetriX" Drawer?
  232.  
  233.  o You should have a copy of "Mathtrans.Library" somewhere...
  234.    This is usually already present, but it may be worth checking.
  235.  
  236.  
  237.  
  238.  Copyright:
  239.  ----------
  240.  
  241.  MetriX V1.0 - © November 1997 : Stu Mackie.
  242.  Docs(s) and Graphics likewise.
  243.  
  244.  Compiled using Blitz Basic 2.1 from Acid Software.
  245.  
  246.  
  247.  Distribution
  248.  ------------
  249.  
  250.  "MetriX" is freely distributable. It may be put on any
  251.  media which is used for the distribution of free software, like Public
  252.  Domain disk collections, CD-ROMs, Aminet (I can't put it there myself -
  253.  no Net access I'm afraid)...etc...
  254.  
  255.  o This package should be made available to anyone free of charge,
  256.    whenever possible.
  257.  
  258.  o If it appears on any CDs, PD libraries, disks etc., then just do
  259.    me a favour and let me know - no need to send me a copy of the media
  260.    unless you're feeling generous.
  261.  
  262.  o Hey! This doesn't mean you can rip off me graphics or source for another
  263.    platform - holy moley!!! Well at least not without asking.
  264.  
  265.  o Try and keep the files together, space permitting.
  266.  
  267.  
  268.  Disclaimer:
  269.  -----------
  270.  
  271.  There is no warranty for this software package. Although I've tried
  272.  (oh how I've tried) to prevent nasty bugs, I can't guarantee that it
  273.  is 1OO% reliable. It's written in an Amiga-friendly way. and hasn't
  274.  caused me any problems, but it's customary to cover one's back, is
  275.  it not? So you use this package at your own risk. I can't be held
  276.  responsible for misuse, or having to reformat your hard-drive coz
  277.  it fall down go boom.
  278.  
  279.  I'm no expert whizkid Amiga coder so there!
  280.  
  281.  Follow the instructions properly, and you should have no probs.
  282.  
  283.  
  284.  First Contact...
  285.  ----------------
  286.  
  287.  If you wish, you can reach me thru this address:
  288.  
  289.  Stu Mackie.
  290.  9O Oakwood Road,
  291.  Halewood,
  292.  Liverpool (Yes, yes, yes, where The Beatles came from),
  293.  Merseyside,
  294.  England,
  295.  L26 1XH.
  296.  
  297.  As this is only a contact address, please don't place obscenities
  298.  on any postcards/envelopes, as the old guys'll only ask me what
  299.  it all means. Not that any self-respecting Amigan would behave in
  300.  such a manner? So keep all obscenities INSIDE the envelope!
  301.  
  302.  
  303.